home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / seekeasy.zip / SEEKREAD.ME < prev   
Text File  |  1987-08-18  |  18KB  |  370 lines
  1.  
  2.                    This is the SEEKREAD.ME file for the 
  3.                    SeekEasy program and its associated 
  4.                    utilities, revised August 14, 1987.
  5.  
  6.  
  7. To obtain a hardcopy of this document from your printer, turn on your printer, 
  8. then at the DOS ">" prompt type COPY SEEKREAD.ME PRN and press Enter.
  9.  
  10. To read this from your screen, type the DOS command TYPE SEEKREAD.ME and then 
  11. press Enter.  To stop/start the scrolling, use control-S/control-Q.
  12.  
  13.  
  14.                         Major items in this document:
  15.                         ----------------------------
  16.  
  17. - What is SeekEasy (overview).
  18. - Discussion of files on the full-package disk.
  19. - Brief manual for SeekEasy.
  20. - Miscellaneous.
  21. - How to convert SeekEasy data files to/from ASCII.
  22. - Discussion of the user-supported software concept.
  23. - Why to register - what's in it for you.
  24. - How to register.
  25. - Reviewer comments.
  26.  
  27.  
  28.                               What is SeekEasy?
  29.                               ----------------
  30.  
  31. SeekEasy is a VERY easy-to-use, "flexible match" information-retrieval 
  32. program.  It lets you search a file for a character string, and returns the 
  33. "best matches" it finds to your request, listed in the order of match quality.  
  34. It does this even if the item found is not exactly what you requested, has 
  35. words in it that were not in your request, doesn't use words spelled exactly 
  36. the same way, etc.
  37.  
  38. With SeekEasy, "Close Is Good Enough!"
  39.  
  40. An example:
  41.  
  42.   Assume a file of quotations contained the quote:
  43.  
  44.           "Muddy water, let stand, will clear."
  45.  
  46.   If you asked SeekEasy to look for "wattter isclearungg if muddie" or "all 
  47.      muddy water clears eventually" or ... etc., SeekEasy will still find it!
  48.  
  49. SeekEasy lets you find items when you only "pretty much" remember how you 
  50. filed them - or aren't even sure WHAT is in the database, but want to see 
  51. everything on a particular topic.  Typical applications:
  52.  
  53.      - Indexing photographs by their descriptions.
  54.      - Finding information filed and indexed by someone else.  With SeekEasy, 
  55.           you don't have to "think like the person who filed it" to be able to 
  56.           find information later.
  57.      - Storing miscellaneous facts all in a heap, for later recall by topic as 
  58.           needed.
  59.      - Storing Table Of Contents entries from magazines, so even YEARS later 
  60.           you can find all articles on a given topic!  How many times have you 
  61.           wished for THIS ability?
  62.      - Etc.
  63.  
  64. SeekEasy will store items into files of its own unique data format, and it 
  65. will search its own data files or virtually any other file, even .COM and .EXE 
  66. files if you wish.  For files in SeekEasy data format, SeekEasy supports 
  67. editing, deleting, etc. of the data.  For non-SeekEasy formats only searching 
  68. is allowed.
  69.  
  70. For more information, see the "Brief Manual on SeekEasy" section a bit farther 
  71. on in this document.
  72.  
  73.                     Files on the full-package user's disk:
  74.                     -------------------------------------
  75.  
  76. SEEKREAD.ME  - This document.
  77. SEEKEASY.EXE - This is the SeekEasy program itself.  This is all that is 
  78.                absolutely required to run SeekEasy.
  79. SEEKEASY.DAT - This is a demonstration SeekEasy data file containing a number 
  80.                of amusing and/or interesting quotations.  SeekEasy defaults to 
  81.                this data file name unless a different name is specified.
  82. PC-SIG.DAT   - This contains a short-form index of the PC-SIG library of 
  83.                public-domain and user-supported software, in SeekEasy format.
  84. SEEK2ASC.COM - This is a conversion program that converts SeekEasy data files 
  85.                into standard ASCII format that can be read by most other 
  86.                programs and word processors.
  87. ASC2SEEK.COM - This is a conversion program that does the reverse of the above  
  88.                - it takes ASCII input (or WordStar, or many word-processor 
  89.                formats) and converts it into a SeekEasy-format data file.
  90.  
  91.  
  92.                           Brief manual on SeekEasy:
  93.                           ------------------------
  94.  
  95. This will give you enough information to use SeekEasy and see how you like it.  
  96. Registered users receive a printed manual that is larger.
  97.  
  98. Before you use SeekEasy, you should make backup copies of the SeekEasy program 
  99. itself and all the data files you wish to preserve.  The standard DOS "COPY" 
  100. command works fine for this.
  101.  
  102. To run SeekEasy, at the DOS ">" prompt just type "SEEKEASY".  This will start 
  103. SeekEasy with its default settings, and using the default data file name 
  104. "SEEKEASY.DAT".
  105.  
  106. To obtain instructions on how to use SeekEasy on any datafile name you wish, 
  107. and to optionally begin searching the file for text without further input, at 
  108. the DOS ">" prompt type "SEEKEASY ?" and instructions will be displayed.
  109.  
  110. SeekEasy operations:
  111.  
  112. SeekEasy operates on "items" that are a maximum of two screen lines long.  
  113. They are limited to this length to avoid the "false matches" that could occur 
  114. if whole screens' worth of text were compared to a search request.
  115.  
  116. SeekEasy normally starts out ready to "Search" for something.  The prompting 
  117. message near the bottom of the screen will tell you how to select the "mode 
  118. select" menu.  This menu gives you the following choices of modes, all self-
  119. prompting as they are called up:
  120.  
  121. - Search:  This allows you to find information stored in the file.
  122.           It "overlaps" or "duplicates" lines of text for NON-SeekEasy files.  
  123.           See the full manual for why this is a good and useful thing.
  124.  
  125. - Store:  This lets you add information to your current SeekEasy data file.  
  126.           It is available for SeekEasy-format files only.
  127.  
  128. - List:   This displays all file contents, one screen's worth of items at a 
  129.           time.
  130.  
  131. - Pack:   This "squeezes" SeekEasy-format files by eliminating items that have 
  132.           been marked as "deleted" by the program.
  133.  
  134. - File Erase:  This erases the current SeekEasy-format data file and creates a 
  135.           new, empty file of the same name.
  136.  
  137. Items displayed on the screen may be edited or deleted during "Search" or 
  138. "List" operations with SeekEasy-format data files.  The screen prompting 
  139. messages will tell you how.
  140.  
  141. When in doubt, create a dummy file and experiment.  The context-sensitive 
  142. screen prompts should tell you all you need to know.
  143.  
  144.  
  145.                             Miscellaneous topics:
  146.                             --------------------
  147.  
  148. SeekEasy runs on PC-DOS or MS-DOS 2.0 or higher.
  149.  
  150. SeekEasy requires 75K of available RAM to run.  This is not a problem with 
  151. most systems, unless they are filled up with memory-resident utilities.
  152.  
  153. SeekEasy will work with data files up to 4 megabytes in size.
  154.  
  155.  
  156.              Converting SeekEasy data files to/from ASCII format:
  157.              ---------------------------------------------------
  158.  
  159.                                Using SEEK2ASC:
  160.  
  161. For some applications you may wish to convert the SeekEasy-format data file 
  162. into standard ASCII that can be read by many word processors and other 
  163. programs such as TYPE, SORT, etc.
  164.  
  165. For example, you might want to alphabetize a SeekEasy database by using the 
  166. standard DOS SORT program.  To do this, you would have to convert your 
  167. SeekEasy data file to ASCII, run the SORT program, then convert your file back 
  168. to SeekEasy format.
  169.  
  170. To convert a SeekEasy data file into an ASCII file, you must run SEEK2ASC.COM.  
  171. To do this be sure SEEK2ASC.COM is in your current directory or in your 
  172. current PATH list, and at the DOS ">" prompt type "SEEK2ASC" and press Enter.
  173.  
  174. The program will prompt you for the name of the file to be converted, then the 
  175. name of the destination file to put the converted information into.  The 
  176. input file will not be altered by the conversion process.
  177.  
  178. The converted file will be approximately the same size as the original 
  179. SeekEasy data file.  Be sure to have enough free disk space to hold it.  You 
  180. can specify different disk drives and different path names for both the input 
  181. file and the output file.  Just include this information in the filenames when 
  182. they are requested by the SEEK2ASC program.
  183.  
  184.                                Using ASC2SEEK:
  185.  
  186. This essentially does the "reverse" of SEEK2ASC - it converts an ASCII file 
  187. into a SeekEasy-format file.
  188.  
  189. You might need to use this program if you have an existing database or list of 
  190. information - say a telephone book filled with names, phone numbers, and 
  191. addresses - that you want to convert into a SeekEasy data file.  After 
  192. conversion to the SeekEasy data format, you can edit/delete items from within 
  193. SeekEasy, and the display is clearer than for non-SeekEasy files.
  194.  
  195. To convert a standard ASCII data file into a SeekEasy-format file, you must 
  196. run ASC2SEEK.COM.  To do this be sure ASC2SEEK.COM is in your current 
  197. directory or in your current PATH list, and at the DOS ">" prompt type 
  198. "ASC2SEEK" and press Enter.
  199.  
  200. The program will prompt you for the name of the file to be converted, then the 
  201. name of the destination file to put the converted information into.  The 
  202. input file will not be altered by the conversion process.
  203.  
  204. The converted file will be approximately the same size as the original ASCII 
  205. data file.  Be sure to have enough free disk space to hold it.  You can 
  206. specify different disk drives and different path names for both the input file 
  207. and the output file.  Just include this information in the filenames when they 
  208. are requested by the ASC2SEEK program.
  209.  
  210.          A cautionary note:
  211.          -----------------
  212.          SeekEasy restricts "items" to two screen lines.  The opening 
  213.          screen of the ASC2SEEK program will give more details.  If 
  214.          the file is one that has been converted to ASCII from 
  215.          SEEKEASY and is now being converted back with only minor 
  216.          modifications, there will probably be no problem.  If, 
  217.          however, the file has never been a SeekEasy file, longer 
  218.          items in the file will probably run afoul of the two-line 
  219.          limit.
  220.  
  221.          The conversion program will flag these problems as they 
  222.          occur, so they can be corrected by shortening items as 
  223.          required and re-running the conversion program.  If this 
  224.          happens, error messages will be displayed on the screen 
  225.          during the conversion process.
  226.  
  227. The ASC2SEEK program will accept various kinds of ASCII files.  It accepts 
  228. WordStar or other "high-bit set" files, and many others.  It filters out 
  229. control characters and other non-printing characters.  Again, see the opening 
  230. screen of the program for more details.  If you have any doubts, try 
  231. converting a file and see what happens.
  232.  
  233.  
  234.               User-supported software - as applied to SeekEasy:
  235.               ------------------------------------------------
  236.  
  237. SeekEasy is "User-supported software."  This is software that may be freely 
  238. copied, but for which the copyright and other intellectual property rights are 
  239. retained by the owner.  A user who finds the program useful after trying it is 
  240. expected to "register" his copy and pay for it.
  241.  
  242. User-supported software is different from Public Domain software in that the 
  243. authors of Public Domain software distribute that software for non-commercial 
  244. use by anyone, without expectation of payment by users.
  245.  
  246. With user-supported software, the user can "try before he buys" - a much 
  247. better situation than what exists for most software available today!
  248.  
  249. If a user finds a user-supported software program useful, he is expected to 
  250. pay a registration fee to the program's authors.  There are a number of 
  251. reasons for registering, beyond the simple fairness of "paying for what you 
  252. get" - see the section below.
  253.  
  254.  
  255.                                 WHY register?
  256.                                 ------------
  257.  
  258. Why register?  Lots of reasons:
  259.  
  260. - Pulling your own weight.  If in your opinion you obtain value from this 
  261.      product, you should pay for it.
  262.  
  263. - Paying the authors enables them to improve SeekEasy and to develop new 
  264.      products.  This is "free market feedback" in its purest form.
  265.  
  266. - You receive benefits for registering:
  267.      A)  We send you a disk with the most current version of SeekEasy.
  268.      B)  We send you a printed manual with much more information than is in 
  269.           the short manual in this document.
  270.      C)  On the disk we send you are programs and data files you may not have 
  271.           gotten along with the SeekEasy program itself.  Examples: SEEK2ASC; 
  272.           ASC2SEEK; a file of unusual quotes - SEEKEASY.DAT; and our version 
  273.           of the index for the PC-SIG library of Public Domain and user-
  274.           supported software in PC-SIG.DAT.  Others added as available.
  275.      D)  You receive the right to unlimited telephone support from us for all 
  276.           SeekEasy-related questions.  We can't help you with general PC-DOS 
  277.           questions, but anything to do with SeekEasy's operation we will be 
  278.           happy to talk to you about.
  279.      E)  You will be notified by mail as upgrades to SeekEasy are available.
  280.  
  281.  
  282.                                HOW to register:
  283.                                ---------------
  284.  
  285. To register, send $30, your name and address, and the disk format you would 
  286. like (5-1/4" or 3-1/2") to:
  287.                              Correlation Systems
  288.                              81 Rockinghorse Road
  289.                         Rancho Palos Verdes, CA 90274
  290.                                 (213) 833-3462
  291.  
  292. California users add sales tax to the $30 (sorry about that).  Foreign users 
  293. add $10.00 to cover our additional costs.
  294.  
  295. Checks or VISA/MC O.K. - for VISA/MC, send card number, expiration date, the 
  296. name on the card, and your signature.
  297.  
  298. We will promptly send you your full SeekEasy package upon receipt of your 
  299. registration.  We normally turn around registrations in two working days.
  300.  
  301. If you wish, you can make a copy of what follows (do a shift-PrtSc or however 
  302. you wish to get it onto paper), fill it out, and send it to us:
  303.  
  304.  ----------------------------------------------------------------------------
  305.  |                    SeekEasy Registration Form                            |
  306.  |                                                                          |
  307.  |                            Send to:                                      |
  308.  |                        Correlation Systems                               |
  309.  |                        81 Rockinghorse Road                              |
  310.  |                   Rancho Palos Verdes, CA 90274                          |
  311.  |                                                                          |
  312.  | Registered user's name: ________________________________________________ |
  313.  |                                                                          |
  314.  | Number/street: ________________________________________________________  |
  315.  |                                                                          |
  316.  | City/state/zip: _______________________________________________________  |
  317.  |                                                                          |
  318.  | Payment method:  _____ Check enclosed  ______ VISA   ______ M/Charge     |
  319.  |                                                                          |
  320.  | If VISA/MC, card #: ______________________________  Expiration: ________ |
  321.  |                                                                          |
  322.  |     Name on card (print): ______________________________________________ |
  323.  |                                                                          |
  324.  |                Signature: ______________________________________________ |
  325.  |                                                                          |
  326.  | Desired disk format:  ______ 3-1/2"      ______ 5-1/4"                   |
  327.  ----------------------------------------------------------------------------
  328.  
  329.  
  330.                               Reviewer comments:
  331.                               -----------------
  332.  
  333. IT DOESN'T CARE HOW DISORGANIZED I AM.  NOR IS IT MUCH BOTHERED BY SLOPPY 
  334. TYPING. ... IN FACT, YOU CAN THROW EVERYTHING YOU WANT TO ORGANIZE INTO THE 
  335. SAME FILE - ADDRESSES, BIRTHDAYS, LIBRARIES, RECIPES - AND SORT OUT WHAT YOU 
  336. WANT WHEN YOU NEED IT.
  337.                               - Richard O'Reilly - Los Angeles Times
  338.  
  339. FOR THE RECORD, SEEKEASY IS THE ONLY SOFTWARE PROGRAM REVIEWED BY ME TO EVER 
  340. OBTAIN A PERFECT GRADE IN EVERY CATEGORY.  IT'S THE ONLY ONE I FELT THAT TRULY 
  341. DESERVED IT!
  342.                               - The NEC 8000 newsletter
  343.  
  344. TO ANYONE WHO HAS EVER TRIED TO FIND A LINE OF INFORMATION IN A LARGE DATA 
  345. FILE, AND FAILED BECAUSE THEY COULD NOT REMEMBER THE RIGHT KEY CODE (OR USED 
  346. THE WRONG ONE), HERE IS THE ANSWER!
  347.                               - David H. Hudson - Computing For Business
  348.  
  349. WHAT MAKES SEEKEASY SIMPLE TO USE IS PRIMARILY THE FACT THAT THERE IS NO 
  350. FORMAT TO SET UP, NO FIELDS TO WORRY ABOUT, AND NO COMPLICATED 300-PLUS PAGES 
  351. OF DOCUMENTATION TO STUDY.  IT IS ALMOST TOO SIMPLE.  JUST TYPE IN YOUR DATA 
  352. AND SAVE THEM.  THAT'S ALL.  IF THAT SOUNDS EASY, YOU WILL FIND IT EVEN EASIER 
  353. TO SEARCH AND RETRIEVE YOUR DATA, BECAUSE YOU DON'T EVEN HAVE TO SPELL 
  354. CORRECTLY!  THAT'S RIGHT.  SEEKEASY WILL FIND ANYTHING WHICH IS EVEN CLOSE TO 
  355. YOUR INQUIRY.
  356.                               - Doug Pencille - MicroTimes
  357.  
  358.  
  359. -----------------------------------------------------------------------------
  360.  
  361. To obtain a hardcopy of this document from your printer, turn on your printer, 
  362. then at the DOS ">" prompt type COPY SEEKREAD.ME PRN and press Enter.
  363.  
  364. To read this from your screen, type the DOS command TYPE SEEKREAD.ME and then 
  365. press Enter.  To stop/start the scrolling, use control-S/control-Q.
  366.  
  367. You may freely copy SeekEasy and its related files for others to use, as long 
  368. as the program remains unaltered.
  369.  
  370.